home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.4 Applications 1997 August / SGI IRIX 6.4 Applications 1997 August.iso / dist / insight.idb / usr / share / catman / u_man / cat1 / iiv.z / iiv
Encoding:
Text File  |  1997-07-30  |  11.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4. IIIINNNNSSSSIIIIGGGGHHHHTTTT((((1111))))                                                          IIIINNNNSSSSIIIIGGGGHHHHTTTT((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      insight, iiv - The IRIS InSight Online Documentation (Book) Viewer
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      /usr/sbin/insight [ -v bbbbooooooookkkk____nnnnaaaammmmeeee ] [ -b bbbbooooooookkkksssshhhheeeellllffff____nnnnaaaammmmeeee ]
  13.                        [ -attrib aaaattttttttrrrriiiibbbbuuuutttteeee____ssssttttrrrriiiinnnngggg ] [ -h ssssttttyyyylllleeeesssshhhheeeeeeeetttt ]
  14.                        [ -l lllliiiibbbbrrrraaaarrrryyyy____nnnnaaaammmmeeee ] [ -auth aaaauuuutttthhhhoooorrrriiiizzzzaaaattttiiiioooonnnn____ssssttttrrrriiiinnnngggg ]
  15.                        [ -print ] [ -r ] [ -f ]
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      The _I_R_I_S _I_n_S_i_g_h_t _V_i_e_w_e_r is an online information retrieval system. This
  19.      viewer provides an easy-to-use interface which allows the user to search
  20.      and browse through online information that is distributed from _S_i_l_i_c_o_n
  21.      _G_r_a_p_h_i_c_s.
  22.  
  23. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  24.      Command line options are described below.
  25.  
  26.      -v   The -v bbbbooooooookkkk____nnnnaaaammmmeeee option tells _i_n_s_i_g_h_t to invoke only the Viewer
  27.           window, and to load the specified book.  The bbbbooooooookkkk____nnnnaaaammmmeeee is the
  28.           abbreviated short title for the book.  This title can be found on
  29.           the stow icon for the book, or from the candidate list of the
  30.           library window during a search. Note that this option is case-
  31.           sensitive. For example,
  32.  
  33.           iiiinnnnssssiiiigggghhhhtttt ----vvvv IIIIRRRRIIIISSSSEEEEsssssssseeeennnnttttiiiiaaaallllssss
  34.  
  35.      -b   The -b bbbbooooooookkkksssshhhheeeellllffff____nnnnaaaammmmeeee option tells _i_n_s_i_g_h_t to invoke the Library
  36.           (main) window, and to load only the specified bookshelf.
  37.  
  38.           A bookshelf is defined as a directory containing a set of books.  By
  39.           default, bookshelves are located in
  40.           /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y/_S_G_I__b_o_o_k_s_h_e_l_v_e_s.
  41.  
  42.           To examine a sample bookshelf, look under the default path of
  43.           /usr/share/Insight/library/SGI_bookshelves. All the directories
  44.           contained under this area are defined as "bookshelves". They are
  45.           displayed in the viewer as a vertically-stacked shelf, containing a
  46.           set of books. By convention, below each of those directories exists
  47.           another directory, called "books".
  48.  
  49.           The path to the bookshelf should be specified (this can be a
  50.           relative pathname), along with the bookshelf name.  For example,
  51.  
  52.           iiiinnnnssssiiiigggghhhhtttt ----bbbb
  53.                  ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____AAAAddddmmmmiiiinnnn
  54.  
  55.           will load only the SGI_Admin bookshelf in the library viewer.
  56.  
  57.           This option also allows for a semi-colon delimited list of
  58.           bookshelves, surrounded by double-quotes. For example, the following
  59.           is a valid parameter to the -b option:
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIINNNNSSSSIIIIGGGGHHHHTTTT((((1111))))                                                          IIIINNNNSSSSIIIIGGGGHHHHTTTT((((1111))))
  71.  
  72.  
  73.  
  74.           """"////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbbrrrraaaarrrryyyy////SSSSGGGGIIII____bbbbooooooookkkksssshhhheeeellllvvvveeeessss////SSSSGGGGIIII____AAAAddddmmmmiiiinnnn;;;;mmmmyyyy____sssshhhheeeellllffff""""
  75.  
  76.  
  77.      -l   The -l lllliiiibbbbrrrraaaarrrryyyy____nnnnaaaammmmeeee option tells _i_n_s_i_g_h_t to invoke the Library
  78.           (main) window, and to load the specified library.  A library is
  79.           defined as a collection of bookshelves. By default, the library is
  80.           rooted at /_u_s_r/_s_h_a_r_e/_I_n_s_i_g_h_t/_l_i_b_r_a_r_y. The path (relative or full) to
  81.           the new library should be specified. Only one library may be
  82.           specified. For example,
  83.  
  84.           iiiinnnnssssiiiigggghhhhtttt ----llll ////uuuussssrrrr////sssshhhhaaaarrrreeee////IIIInnnnssssiiiigggghhhhtttt////lllliiiibbbb____XXXXXXXXXXXX
  85.  
  86.      -r   The -r option is used in conjunction with the -v option. It
  87.           instructs the _i_n_s_i_g_h_t software to load the specified book in a
  88.           "restricted" viewer.  A restricted viewer is defined as one that
  89.           does not have a Table-of-Contents navigation area.
  90.  
  91.      -attrib
  92.           The -attrib aaaattttttttrrrriiiibbbbuuuutttteeee____ssssttttrrrriiiinnnngggg option is used in conjunction with the
  93.           -v option. It instructs the _i_n_s_i_g_h_t software to load the specified
  94.           book, and scroll to a particular entry point.  That entry point is
  95.           designated by the result which is generated from the attribute
  96.           string. Note that the aaaattttttttrrrriiiibbbbuuuutttteeee____ssssttttrrrriiiinnnngggg must be enclosed in double-
  97.           quotes in order to be properly interpreted.
  98.  
  99.           For any invalid expressions, or those that cannot be resolved,
  100.           _i_n_s_i_g_h_t will simply invoke the book in the Viewer, and will not
  101.           scroll to any particular entry point.
  102.  
  103.           Although rarely used by an end-user, the following attribute
  104.           commands are available :
  105.  
  106.  
  107.           _q_u_e_r_y(_e_x_p_r_e_s_s_i_o_n)
  108.  
  109.           takes any expression valid in the _i_n_s_i_g_h_t query language, and
  110.           returns the entry point of the first element in the specified book
  111.           that matches the expression. For more information on the query
  112.           language, please consult the IIIIRRRRIIIISSSS IIIInnnnSSSSiiiigggghhhhtttt oooonnnn----lllliiiinnnneeee hhhheeeellllpppp.
  113.  
  114.           For example, a user could specify the following:
  115.  
  116.           iiiinnnnssssiiiigggghhhhtttt ----vvvv PPPPeeeerrrrSSSSyyyyssssAAAAddddmmmmiiiinnnn ----aaaattttttttrrrriiiibbbb """"qqqquuuueeeerrrryyyy((((mmmmaaaannnnaaaaggggiiiinnnngggg pppprrrriiiinnnntttteeeerrrrssss))))"""".
  117.  
  118.           The result would bring up the Personal System Administration Guide
  119.           and take them to the first area in the book that contained the
  120.           phrase "managing printers".
  121.  
  122.  
  123.           _i_d_m_a_t_c_h(_n_a_m_e, _v_a_l_u_e)
  124.  
  125.           is a special case of query(), which searches in the current book for
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. IIIINNNNSSSSIIIIGGGGHHHHTTTT((((1111))))                                                          IIIINNNNSSSSIIIIGGGGHHHHTTTT((((1111))))
  137.  
  138.  
  139.  
  140.           the first element which has an attribute with the specified 'name'
  141.           and 'value' and returns the entry point for that element. If the
  142.           'name' argument is omitted (i.e., if there is only one argument, or
  143.           the first of two arguments is empty), then only attributes named ID
  144.           will be considered.  This function is used to implement the most
  145.           common kind of hypertext link in SGML (Standard Generalized Markup
  146.           Language).
  147.  
  148.           For example:
  149.  
  150.           iiiinnnnssssiiiigggghhhhtttt ----vvvv PPPPeeeerrrrSSSSyyyyssssAAAAddddmmmmiiiinnnn ----aaaattttttttrrrriiiibbbb """"iiiiddddmmmmaaaattttcccchhhh((((111188880000))))"""".
  151.  
  152.  
  153.           _a_n_c_e_s_t_o_r(_e_x_p_r_e_s_s_i_o_n)
  154.  
  155.           returns returns the immediate parent element (entry point) for the
  156.           enclosed expression.
  157.  
  158.           _l_s_i_b_l_i_n_g(_e_x_p_r_e_s_s_i_o_n)
  159.  
  160.           returns the preceding sibling element (entry point) for the enclosed
  161.           expression.
  162.  
  163.           _r_s_i_b_l_i_n_g(_e_x_p_r_e_s_s_i_o_n)
  164.  
  165.           similar to _l_s_i_b_l_i_n_g(_e_x_p_r_e_s_s_i_o_n), but returns the next sibling
  166.           element (entry point) for the enclosed expression.
  167.  
  168.      -h   The -h ssssttttyyyylllleeeesssshhhheeeeeeeetttt option is used in conjunction with the -v option.
  169.           It instructs the _i_n_s_i_g_h_t software to load the specified book, using
  170.           the specified stylesheet.  Although rarely used by an end-user, it
  171.           is available.
  172.  
  173.      -print
  174.           The -print option is used to open the print window automatically for
  175.           the book specified by the -v bbbbooooooookkkk____nnnnaaaammmmeeee option.
  176.  
  177.      -auth
  178.           The -auth aaaauuuutttthhhhoooorrrriiiizzzzaaaattttiiiioooonnnn____ssssttttrrrriiiinnnngggg option instructs _i_n_s_i_g_h_t to use the
  179.           designated string as an authorization key for reading books that
  180.           have been licensed. At this time, this option will not be needed for
  181.           accessing the online books from _S_i_l_i_c_o_n _G_r_a_p_h_i_c_s.
  182.  
  183.      -f   The -f option tells _i_n_s_i_g_h_t to run in the foreground, and to disable
  184.           "run-once" behavior.  "Run-once" is when oooonnnneeee copy of IRIS InSight
  185.           can be invoked, per X-display. By default, "run-once" behavior is
  186.           turned on.
  187.  
  188.      For additional information, please consult the IIIIRRRRIIIISSSS IIIInnnnSSSSiiiigggghhhhtttt oooonnnn----lllliiiinnnneeee hhhheeeellllpppp.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. IIIINNNNSSSSIIIIGGGGHHHHTTTT((((1111))))                                                          IIIINNNNSSSSIIIIGGGGHHHHTTTT((((1111))))
  203.  
  204.  
  205.  
  206. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  207.      _s_g_i_h_e_l_p(_1)
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                                                         PPPPaaaaggggeeee 4444
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.